CROSS-ASSEMBLER DIRECTIVES 
(CONCLUDED) 


PAGE TITLE TITL 
TITL supplies title to be printed in the heading of each page of the source listing. 

Syntax: [<label>] TITL ‘<string>’ [<comment >] 
RESTART SOURCE LISTING LIST 
LIST restores printing of the source tisting. 

Syntax: [<label >] LIST [<comment >] 
STOP SOURCE LISTING UNL 
UNL halts the source listing output until the occurrence of a LIST directive. 

Syntax: {<labeil >] UNL {<comment >] 
EJECT PAGE PAGE 


PAGE causes the assembler to continue the source program listing on a new page. The PAGE direc- 
tive is not printed in the source listing, but the line counter increments. 


Syntax: [<label>} PAGE {<comment>|] 
INITIALIZE WORD DATA 
DATA places one or more values in one or more successive words of memory. 
Syntax: [<label>] DATA <exp>|,<exp>] {[<comment >] 
INITIALIZE TEXT TEXT 


TEXT places one or more characters in successive words of memory. 


Syntax: [<label>] TEXT {-]' <string>’ {<comment>] 
DEFINE ASSEMBLY-TIME CONSTANT EQu 
EQU assigns a value to a symbol. 

Syntax: <label> EQU <exp> {<comment >] 
EXTERNAL DEFINITION DEF 


DEF makes one or more symbols available to other programs for reference. 


Syntax: [<label >] DEF <symbol >[,<symbol >] [<comment >] 
EXTERNAL REFERENCE REF 
REF provides access to one or more symbols defined in other programs. 

Syntax: [<label>} REF 


<symbo! >[,<symbol >] [<comment >] 


SECONDARY EXTERNAL REFERENCE SREF 
SREF provides access to one or more symbols defined in other programs. 

Syntax: [<label>] SREF <symbol >[,<symbol>] f<comment >] 
FORCE LOAD LOAD 


LOAD is similar to REF, but the symbol does not need to be used in the module containing the LOAD. 
The symbol used in LOAD must be defined in some other module. LOADs are used with SREFs. 


Syntax: [<labet>] LOAD <symbol>[, <symbol >] [<comment>] 
PROGRAM END END 


END terminates the assembly. The last source statement of a program is the END directive. 


Syntax: [<tabel>] END {<symbol >] {<comment>] 
COPY SOURCE FILE COPY 
COPY changes the source input for the assembier. : 

Syntax: |<label>] COPY <file name> {<comment >] 
DEFINE MACRO LIBRARY MLB 


MLIB provides the name of a library containing macro definitions. 


Syntax: [<label>] MLIiB ‘<pathname >’ [<comment>] 


TMS32010 
DIGITAL SIGNAL PROCESSOR 
Programmer's Reference Card 


0 
1 
2 
3 
4 
5 
6 
7 
8 
9 
A 
B 
Cc 
D 
E 
F 


RTC HOTLINE NUMBERS 


For help with the TMS32010, call the Tl Regional Technology 
Center nearest you. The centers are staffed with applications 
engineers ready to answer all your questions. 


Atlanta 404/452-4686 
Boston 617/890-4271 
Chicago 312/228-6008 
Dallas 214/680-5096 


Northern California 408/980-0305 
Southern California 714/660-8164 


TEXAS 
INSTRUMENTS 


Tame 


SYMBOLS FOR INSTRUCTION SET SUMMARY 
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SYMBOL 


MEANING 


Data memory address field 
Addressing mode bit 


K Immediate operand field 

PA 3-bit port address field (PAO through PA7 are predefined assembler symbols 
equal to O through 7, respectively) 

R 1-bit operand field specifying auxiliary resister 

S 4-bit left-shift code 

x 3-bit accumulator left-shift field 


NO. OPCODE 
WORDS INSTRUCTION REGISTER 
1981413121110 9 8765 43 21 0 
ABS Absolute value of 011714111 %11000810080 
accumulator 
ADD Add to accumulator 1 1 6.0 0 0 —5-——) 1. <8 
with shift 
ADDH Add to high-order 1 1 011000001 <——D)D—-~> 
accumulator bits 
ADDS Add to accumulator 1 1 0110000311 <——D—> 
with no sign extension 
AND AND with accumulator 1 1 01411100818 «| ~€&——D—> 
APAC = Add P Register to 1 1 01171417141 171000%8 14°21 «23 
accumulator 
8B Branch unconditionally 2 2 1171110°03100e000000 
0 0 0 0 <——— BRANCH ADDRESS ———> 
BANZ _ Branch on auxiliary 2 2 11110 %t100000000%00 0 
resister not zero 0 0 0 0 <——~ BRANCH ADDRESS ———> 
BGEZ Branch if accumulator 2 2 1171170100000000 
20 0 0 0 0 <————BRANCH ADDRESS ————> 
BGZ Branch if accumulator 2 2 +1711 10000000000 
>0 0 0 0 0 <———BRANCH ADDRESS ———> 
BI0Z —_ Branch on BIO = 0 2 2 71171011000000000 
0 0 0 0 <——— BRANCH ADDRESS ————> 
BLEZ Branch if accumulator 2 2 11111701 100000000 
<0 0.0 0 0 <——B8RANCH ADDRESS ———> 
BLZ Branch if accumulator 2 2 11717 10100000000%0 90 
<0 0 0 G6 OQ <——— BRANCH ADDRESS ———> 
BNZ Branch if accumulator 2 2 1711714 1 1000000000 
#0 0 0 0 0 <——BRANCH ADDRESS ———> 
BV Branch on overflow 2 2 11711010171 00000000 
0 0 0 0 <—— BRANCH ADDRESS ———> 
BZ Branch if accumutator 2 2 11711411 1100000000 
=0 0 0 0 0 <——— BRANCH ADDRESS —-—> 
CALA Cail subroutine from 2 1 oi1tt11%41 1000811 0 0 
accumulator 
CALL Call subroutine 2 2 71111000000060000 080 
immediately 0 0 0 0 <—— BRANCH ADDRESS ———> 
DINT Disable interrupt 1 1 017171 1711000000281 
DMOV Copy contents of data 1 1 01103100318 <<  D-—~> 


memory location into 
next location 


EINT Enable interrupt 1 1 o1i%4%4%411 4710200008108 

IN input data from port 2 1 01000 <PA> 1 <——D—~> 

LAC Load accumulator 1 1 0o0310<S——~> | <——D— > 
with shift 

LACK Load accumulator 1 1 0111771 10<——~— K —~?> 
immediate 

LAR Load auxiliary 1 1 0o0o311100R1 <———D—~> 
register 

LARK Load auxiliary 1 1 0111000 R <——— K —?> 
register immediate 

LARP Load auxiliary 1 1 0o1310606100031000000i(K 
register pointer 
immediate 

LOP Load data memory 1 1 o41031%1%%%1t<—— 0—?> 
page pointer 

LDPK Load data memory 1 1 011011 %10e0000000C%K 
page pointer immediate 

LST Load status register 1 1 013114131 04 «1 <—_- 0D -—~> 

LT Load T Register 1 1 o110t+0310 —— D —_> 

LTA LTA combines LT and 1 1 ot10110 0 <—— - 0b -— 
APAC into one instruc- 
tion 

LTD LTD combines LT, 1 1 o%4710310%41 1 <——~ D—-> 
APAC, and DMOV into 
one instruction 

MAR Modify auxiliary 1 1 01101410008 <— D—> 
register and pointer 

MPY Multiply with T 1 1 o171017011<—— DOD —> 
Register; store product 
in P Register 

MPYK = Multiply T Register 1 1 100 <——— K— ~~ 
with immediate oper- 
and; store product in 
P Register 

NOP No operation 1 1 o17%t1141117 110000000 

OR OR with accumulator 1 1 CTA EPO Ooh —— Oe 

OUT Output data to port 2 1 01001 <PA> | <—— D — > 

PAC Load accumulator from 1 1 0174347943977 7100018% 113 «0 
P Register 

PoP Pop stack to 2 1 o%41%711%931 1%1%0008i1 1 «0 41 
accumulator 

PUSH Push stack from 2 1 o1711174%7 1710087 1 4 «0 0 
accumulator 

RET Return from sub- 2 1 0111414113113 411000811 0 1 
routine 

ROVM _ Reset overflow mode 1 1 o1ttit4tt1000101 «90 

SACH Store high-order 1 1 010311 €X> | <—— D—-> 
accumulator bits with 
shift 

SACL = Store low-order 1 1 010100001 <— D—~> 
accumulator bits 

SAR Store auxiliary 1 1 0o03i131000Rt1 <—— DBD —?> 
register 

SOVM _ Set overflow mode 1 1 o1i11%1171141%10008108~ 21 

SPAC. Subtract P Register 1 1 011114137171 100310000 
from accumulator 

SST Store status register 1 1 o1%11%1100181<— D-—~> 

SUB Subtract from 1 1 0oo0o0o01<sS—> | <— D-—-~> 
accumulator with 
shift _ 

(Continued) 
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INSTRUCTION SET SUMMARY (CONCLUDED) 


MNEMONIC DESCRIPTION OPCODE 
CYCLES | WORDS INSTRUCTION REGISTER 


16 1413121110 9 8 6 5 4 


Conditional subtract 
{for divide) 

Subtract from high- 
order accumulator bits 
Subtract from accumu- 
lator with no sign 
extension 

Table read from 
program memory to 
data RAM 

Table write from 

data RAM to program 
memory 

Exclusive OR with 
accumulator 

Zero accumulator 
Zero accumulator and 
load high-order bits 
Zero accumulator and 
load low-order bits 
with no sign extension 


CROSS-ASSEMBLER DIRECTIVES 


ABSOLUTE ORIGIN . AORG 
AORG places a value in the location counter and defines the succeeding locations as absolute. 


Syntax: [<label>] AORG {<wd-exp>] [<comment >] 

RELOCATABLE ORIGIN RORG 

RORG places a value in the location counter and defines the succeeding locations as program relocatable. 
Syntax: [<label>] RORG [<exp>} [<comment >] 

DUMMY ORIGIN DORG 


DORG places a value in the location counter and defines the succeeding locations as a dummy sec- 
tion. No object code is generated in a dummy section. 


Syntax: [<label>] DORG <exp> [<comment >} 
BLOCK STARTING WITH SYMBOL BSS 


BSS first assigns the label, if present, and then advances the location counter by the value of the 
expression. 


Syntax: [<label>] BSS <wd-exp > [<comment>] 
BLOCK ENDING WITH SYMBOL BES 


BES first advances the location counter by the Value of the expression and then assigns the label, 
if present. 


Syntax: {<label>] BES <wd-exp > [<comment >] 

DATA SEGMENT DSEG 

DSEG places a value in the location counter and defines succeeding locations as data relocatable. 
Syntax: [<label>] DSEG {<comment>] 

DATA SEGMENT END OEND 


DEND terminates a block of data-relocatable code by placing a value in the location counter and defining 
succeeding locations as program-relocatable. 


Syntax: {<label>] DEND {<comment >} 
COMMON SEGMENT CSEG 


CSEG places a value in the location counter and defines succeeding locations as common-relocatable 
{i.e., relocatable with respect to a common segment). 


Syntax: [<label>] CSEG {' <string> [<comment > ]] 
COMMON SEGMENT END CEND 


CEND terminates the definition of a block of common-relocatable code by placing a value in the loca- 
tion counter and defining succeeding locations as program-relocatable. 


Syntax: [<label>] CEND [<comment >] 
PROGRAM SEGMENT PSEG 
PSEG places a value in the location counter and defines succeeding locations as program-relocatable. 
Syntax: [<label>] PSEG [<comment >} 
PROGRAM SEGMENT END PEND 
PEND places a value in the location counter and defines succeeding locations as program-relocatable. 
(Since PEND properly appears only in program-relocatable code, the relocation type of succeeding 
locations remains unchanged.) 
Syntax: {<label>] PEND [<comment >] 
OUTPUT OPTIONS OPTION 
OPTION selects several options for the assembler listing output. 
Syntax: [<label>] OPTION <option-list > [<comment >] 
PROGRAM IDENTIFIER {OT 
IDT assigns a name to the object module produced. 


Syntax: [<label>] IDT ‘<string>’ [<comment>|} 
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